home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / Tools / tin-1.22 / README.OS2 < prev    next >
Text File  |  1995-07-13  |  6KB  |  165 lines
  1. This is the OS/2 port of TIN. 
  2.  
  3. An executable version can be obtained from ftp.cdrom.com.
  4.  
  5. To build TIN, you need the following:
  6.  
  7. - IBM C Set/2 or Borland C++ for OS/2
  8. - PDCurses 2.0 build for the compiler of your choice
  9.  
  10.   For the NNTP version of TIN:
  11.     - IBM TCP/IP 1.2.1 CSD UN37938 or higher,
  12.     - IBM TCP/IP 1.2.1 Programmers's Kit CSD UN37942 of higher, with 
  13.       modifications as outlined below.
  14.  
  15. To run it you need:
  16.  
  17. - set environment variables
  18.   To read news via NNTP
  19.     - TCP/IP access to an nntp server,
  20. - some free space on a HPFS or NFS volume (FAT will not work, due to 8.3 file
  21.   name restriction)
  22.  
  23.   optional:
  24.     - uudecode and uushar utilities
  25.       Note: uudecode is posted regularly to comp.binaries.os2 in the
  26.             "OS/2 Binaries Starter's Kit" by mykek@miller.cs.uwm.edu
  27.             (OS/2 binaries moderator)
  28.  
  29. Building TIN for OS/2
  30.  
  31. 1. Make sure that all source files (*.c and *.h) have <CR><LF> as their 
  32.    line-ends. If not, use 'unix2os2 < original >newfile' to correct this.
  33.  
  34. 2. Select the makefile appropriate for your compiler:
  35.     Makefile.bcc for Borland C++ for OS/2
  36.     Makefile.icc for IBM's C Set/2 Compiler
  37.     Note: Borland C is prefered. You may have to make some adjustments when you
  38.           use IBM's C.
  39.  
  40. 3. Edit the makefile, changing location of include and library files to
  41.    match your installation
  42.  
  43. 4. Correct bugs in \tcpip\include\netdb.h
  44.      find all occurrences of 'char *' that are not followed by '_Seg16' and add
  45.      '_Seg16'. For example change
  46.        SERVENT * _Seg16 _Far16 _Cdecl getservbyname( char *, char * );
  47.      to
  48.        SERVENT * _Seg16 _Far16 _Cdecl getservbyname( char * _Seg16, char * _Seg16 );
  49.      You will also correct the prototype for getservbyport and getprotobyname.
  50.  
  51. 5. If you are using Borland C++, edit the TCP/IP header files:
  52.     in netdb.h, netlib.h sys/socket.h do the following:
  53.       - find the #ifndef __32BIT__ near the top of each file
  54.  
  55.       - change the conditional section as follows:
  56.         #ifndef __32BIT__
  57.         #ifdef __TURBOC__
  58.         #define _Packed
  59.         #define _Seg16 _far16
  60.         #define _Far16 _far16
  61.         #define _Cdecl _cdecl
  62.         #define __32BIT__
  63.         #else
  64.         #define _Packed
  65.         #define _Seg16
  66.         #define _Far16
  67.         #define _Cdecl
  68.         #endif
  69.         #endif
  70.  
  71.       - add the following below the second #endif
  72.         #ifdef __TURBOC__
  73.         #define FAR16P _far16 *
  74.         #else
  75.         #define FAR16P * _Seg16
  76.         #endif
  77.                           
  78.       - throughout the files change '* _Seg16' and '*  _Seg16'  to 'FAR16P'
  79.    After these changes, the TCP/IP package can be used with the Borland C
  80.    compiler.
  81.  
  82. 6. If you are using Borland C++ type 'make -f makefile.bcc'
  83.    If you are using IBM's C Set/2 type 'nmake -f makefile.icc'
  84.    Ignore warnings, especially re _Cdecl and _Seg16 re-definition.
  85.  
  86.  
  87. Using TIN under OS/2
  88.  
  89. To run the local newsspool version, start TIN. To run the NNTP version, 
  90. start TIN -r, or rename TIN.EXE to RTIN.EXE and run RTIN.
  91.  
  92. TIN runs in an OS/2 windowed session. It is not a PM application. TIN needs to
  93. know who you are, in order to create headers for posts and mail correctly.
  94. There are two ways in which you can specify this information:
  95.  
  96. - through environment variables
  97. - through a Unix-style passwd file
  98.  
  99. Environment Variables
  100.  
  101. If only one person is using TIN to post articles, set the following variables
  102. in your config.sys file:
  103.  
  104.   USER userid                           set USER=andreas
  105.   REALNAME Your Full Name               set REALNAME=Andreas Wrede
  106.   HOME \your\home\directory             set HOME=c:\home\andreas
  107.  
  108. Note that you HOME directory must be on a HPFS or NFS disk. FAT will
  109. probably not work, due to the 8.3 file name restriction. 
  110.  
  111.  
  112. Unix-style passwd file
  113.  
  114. If a number of users use TIN to post articles, for example via telnet to the OS/2
  115. machine, it might be easier to use the Unix-style passwd file. The passwd file is
  116. located in the directory set by the environment variable ETC, usually c:\tcpip\etc.
  117. The same passwd file is used by ftp and telnet (via loginunx.exe). See your TCP/IP 
  118. User's Guide for more information. 
  119.  
  120. TIN does no use the password field, but the full user name, the home directory and 
  121. the shell are taken from the passwd file entry. The environment variable USER is 
  122. used to locate the correct entry in the passwd file. If it is not set, an error 
  123. message is issued by TIN. Two sample passwd entries follow:
  124.  
  125. andreas:x:1:1:Andreas Wrede:c:/home/andreas:c:/os2/cmd.exe
  126. guest:x:2:2:Guest User:c:/home/guest:d:/ksh/ksh
  127.  
  128.  
  129. Other Environment Variables
  130.  
  131. Required for NNTP version:
  132.  
  133. NNTPSERVER - either the fully qualified domain name of the nntp server or
  134.              the dotted internet address of the nntp server.
  135.  
  136. HOSTNAME   - specifies the name of your machine. It is used to identify your 
  137.              machine to the nntp server.
  138.  
  139. Required for local newspool version:
  140.  
  141. TIN_SPOOLDIR   - path to the root of the news spool
  142.  
  143. TIN_LIBDIR     - path to news control: active file, newsgroups file etc.
  144.  
  145. TIN_NOVROOTDIR - path to overview files
  146.  
  147. Optional:
  148. LINES  - specify how many lines you display window has. If LINES is not set,
  149.          TIN will use the actual height of the display window. You might need
  150.          to set this if you run TIN from a telnet session.
  151.  
  152. EDITOR -
  153. VISUAL - specify the editor to use for composing articles and replies. 
  154.          Defaults to 'epm'.
  155.  
  156. SHELL -  specify command process to use for shell escapes - defaults to 
  157.          whatever is set by COMSPEC
  158.  
  159.  
  160. For other environment variables, see ENVIRONMENT VARIABLES in tin.man.
  161.  
  162. Enjoy!
  163.  
  164. Andreas Wrede (andreas@scilink.org)
  165.